Crate ecolor

Color conversions and types.

If you want a compact color representation, use Color32. If you want to manipulate RGBA colors use Rgba. If you want to manipulate colors in a way closer to how humans think about colors, use HsvaGamma.

Feature flags

• extra_debug_asserts — Enable additional checks if debug assertions are enabled (debug builds).
• extra_asserts — Always enable additional checks.

Optional dependencies

• bytemuck — bytemuck enables you to cast ecolor types to &[u8].
• cint — cint enables interoperability with other color libraries.
• color-hex — Enable the hex_color macro.
• document-features — Enable this when generating docs.
• serde — Allow serialization using serde.

Macros

• ecolor_assert
  An assert that is only active when epaint is compiled with the extra_asserts feature or with the extra_debug_asserts feature in debug builds.
• hex_color
  Construct a crate::Color32 from a hex RGB or RGBA string.

Structs

• Color32
  This format is used for space-efficient color representation (32 bits).
• Hsva
  Hue, saturation, value, alpha. All in the range [0, 1]. No premultiplied alpha.
• HsvaGamma
  Like Hsva but with the v value (brightness) being gamma corrected so that it is somewhat perceptually even.
• Rgba
  0-1 linear space RGBA color with premultiplied alpha.

Enums

• HexColor
  A wrapper around Color32 that converts to and from a hex-color string
• ParseHexColorError

Functions

• gamma_from_linear
  linear [0, 1] -> gamma [0, 1] (not clamped). Works for numbers outside this range (e.g. negative numbers).
• gamma_u8_from_linear_f32
  linear [0, 1] -> gamma [0, 255] (clamped). Values outside this range will be clamped to the range.
• hsv_from_rgb
  All ranges in 0-1, rgb is linear.
• linear_f32_from_gamma_u8
  gamma [0, 255] -> linear [0, 1].
• linear_f32_from_linear_u8
  linear [0, 255] -> linear [0, 1]. Useful for alpha-channel.
• linear_from_gamma
  gamma [0, 1] -> linear [0, 1] (not clamped). Works for numbers outside this range (e.g. negative numbers).
• linear_u8_from_linear_f32
  linear [0, 1] -> linear [0, 255] (clamped). Useful for alpha-channel.
• rgb_from_hsv
  All ranges in 0-1, rgb is linear.
• tint_color_towards
  Cheap and ugly. Made for graying out disabled Uis.